home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / dev / gcc / gcc260utilsdoc.lha / gnu / man / man1 / chmod.1 < prev    next >
Encoding:
Text File  |  1994-07-26  |  4.3 KB  |  133 lines

  1.  
  2.  
  3.  
  4. CHMOD(1L)         Misc. Reference Manual Pages          CHMOD(1L)
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      chmod - change the access permissions of files
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      cccchhhhmmmmoooodddd [-Rcfv] [--recursive] [--changes] [--silent] [--quiet]
  13.      [--verbose] [--help] [--version] mode file...
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      This manual page documents the GNU version of cccchhhhmmmmoooodddd.   cccchhhhmmmmoooodddd
  17.      changes  the  permissions  of  each  given file according to
  18.      _m_o_d_e, which can  be  either  a  symbolic  representation  of
  19.      changes  to  make,  or  an octal number representing the bit
  20.      pattern for the new permissions.
  21.  
  22.      The  format   of   a   symbolic   mode   is   `[ugoa...][[+-
  23.      =][rwxXstugo...]...][,...]'.   Multiple  symbolic operations
  24.      can be given, separated by commas.
  25.  
  26.      A combination of the letters `ugoa'  controls  which  users'
  27.      access  to  the  file  will be changed: the user who owns it
  28.      (u), other users in the file's group (g), other users not in
  29.      the  file's  group  (o), or all users (a).  If none of these
  30.      are given, the effect is as if `a' were given, but bits that
  31.      are set in the umask are not affected.
  32.  
  33.      The operator `+' causes the permissions selected to be added
  34.      to the existing permissions of each file; `-' causes them to
  35.      be removed; and `=' causes them to be the  only  permissions
  36.      that the file has.
  37.  
  38.      The letters `rwxXstugo' select the new permissions  for  the
  39.      affected  users: read (r), write (w), execute (or access for
  40.      directories) (x), execute only if the file is a directory or
  41.      already  has  execute permission for some user (X), set user
  42.      or group ID on execution (s), save program text on swap dev-
  43.      ice  (t),  the  permissions  that the user who owns the file
  44.      currently has for it (u), the permissions that  other  users
  45.      in  the  file's  group  have for it (g), and the permissions
  46.      that other users not in the file's group have for it (o).
  47.  
  48.      A numeric mode is from  one  to  four  octal  digits  (0-7),
  49.      derived  by adding up the bits with values 4, 2, and 1.  Any
  50.      omitted digits are assumed to be leading zeros.   The  first
  51.      digit  selects  the set user ID (4) and set group ID (2) and
  52.      save text image (1) attributes.  The  second  digit  selects
  53.      permissions  for the user who owns the file: read (4), write
  54.      (2), and execute (1);  the  third  selects  permissions  for
  55.      other  users  in the file's group, with the same values; and
  56.      the fourth for other users not in the file's group, with the
  57.      same values.
  58.  
  59.  
  60.  
  61.  
  62.  
  63. FSF              Last change: GNU File Utilities                1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CHMOD(1L)         Misc. Reference Manual Pages          CHMOD(1L)
  71.  
  72.  
  73.  
  74.      cccchhhhmmmmoooodddd never changes the permissions of symbolic  links;  the
  75.      cccchhhhmmmmoooodddd  system call cannot change their permissions.  This is
  76.      not a problem since the permissions of  symbolic  links  are
  77.      never  used.   However, for each symbolic link listed on the
  78.      command line, cccchhhhmmmmoooodddd changes the permissions of the  pointed-
  79.      to  file.  In contrast, cccchhhhmmmmoooodddd ignores symbolic links encoun-
  80.      tered during recursive directory traversals.
  81.  
  82.   OOOOPPPPTTTTIIIIOOOONNNNSSSS
  83.      -_c, --_c_h_a_n_g_e_s
  84.           Verbosely describe only files whose  permissions  actu-
  85.           ally change.
  86.  
  87.      -_f, --_s_i_l_e_n_t, --_q_u_i_e_t
  88.           Do not print error messages about files  whose  permis-
  89.           sions cannot be changed.
  90.  
  91.      -_v, --_v_e_r_b_o_s_e
  92.           Verbosely describe changed permissions.
  93.  
  94.      -_R, --_r_e_c_u_r_s_i_v_e
  95.           Recursively change permissions of directories and their
  96.           contents.
  97.  
  98.      --_h_e_l_p
  99.           Print a usage message on standard output and exit  suc-
  100.           cessfully.
  101.  
  102.      --_v_e_r_s_i_o_n
  103.           Print version information on standard output then  exit
  104.           successfully.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. FSF              Last change: GNU File Utilities                2
  130.  
  131.  
  132.  
  133.